<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkScaleButton</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
<link rel="home" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="prev" href="GtkLinkButton.html" title="GtkLinkButton">
<link rel="next" href="GtkVolumeButton.html" title="GtkVolumeButton">
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="Builder.html" title="Interface builder">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder">
<link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="api-index-full.html" title="Index of all symbols">
<link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
<link rel="index" href="api-index-2-2.html" title="Index of new symbols in 2.2">
<link rel="index" href="api-index-2-4.html" title="Index of new symbols in 2.4">
<link rel="index" href="api-index-2-6.html" title="Index of new symbols in 2.6">
<link rel="index" href="api-index-2-8.html" title="Index of new symbols in 2.8">
<link rel="index" href="api-index-2-10.html" title="Index of new symbols in 2.10">
<link rel="index" href="api-index-2-12.html" title="Index of new symbols in 2.12">
<link rel="index" href="api-index-2-14.html" title="Index of new symbols in 2.14">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkLinkButton.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ButtonWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkVolumeButton.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkScaleButton.synopsis" class="shortcut">Top</a>
                 | 
                <a href="#GtkScaleButton.description" class="shortcut">Description</a>
                 | 
                <a href="#GtkScaleButton.object-hierarchy" class="shortcut">Object Hierarchy</a>
                 | 
                <a href="#GtkScaleButton.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                 | 
                <a href="#GtkScaleButton.properties" class="shortcut">Properties</a>
                 | 
                <a href="#GtkScaleButton.signals" class="shortcut">Signals</a>
</td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkScaleButton"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkScaleButton.top_of_page"></a>GtkScaleButton</span></h2>
<p>GtkScaleButton — A button which pops up a scale</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkScaleButton.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;gtk/gtk.h&gt;

                    <a class="link" href="GtkScaleButton.html#GtkScaleButton-struct" title="GtkScaleButton">GtkScaleButton</a>;
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *         <a class="link" href="GtkScaleButton.html#gtk-scale-button-new" title="gtk_scale_button_new ()">gtk_scale_button_new</a>                (<a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize">GtkIconSize</a> size,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> min,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> max,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> step,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **icons);
void                <a class="link" href="GtkScaleButton.html#gtk-scale-button-set-adjustment" title="gtk_scale_button_set_adjustment ()">gtk_scale_button_set_adjustment</a>     (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                         <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *adjustment);
void                <a class="link" href="GtkScaleButton.html#gtk-scale-button-set-icons" title="gtk_scale_button_set_icons ()">gtk_scale_button_set_icons</a>          (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **icons);
void                <a class="link" href="GtkScaleButton.html#gtk-scale-button-set-value" title="gtk_scale_button_set_value ()">gtk_scale_button_set_value</a>          (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> value);
<a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *     <a class="link" href="GtkScaleButton.html#gtk-scale-button-get-adjustment" title="gtk_scale_button_get_adjustment ()">gtk_scale_button_get_adjustment</a>     (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>             <a class="link" href="GtkScaleButton.html#gtk-scale-button-get-value" title="gtk_scale_button_get_value ()">gtk_scale_button_get_value</a>          (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *         <a class="link" href="GtkScaleButton.html#gtk-scale-button-get-popup" title="gtk_scale_button_get_popup ()">gtk_scale_button_get_popup</a>          (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *         <a class="link" href="GtkScaleButton.html#gtk-scale-button-get-plus-button" title="gtk_scale_button_get_plus_button ()">gtk_scale_button_get_plus_button</a>    (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *         <a class="link" href="GtkScaleButton.html#gtk-scale-button-get-minus-button" title="gtk_scale_button_get_minus_button ()">gtk_scale_button_get_minus_button</a>   (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);
void                <a class="link" href="GtkScaleButton.html#gtk-scale-button-set-orientation" title="gtk_scale_button_set_orientation ()">gtk_scale_button_set_orientation</a>    (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation">GtkOrientation</a> orientation);
<a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation">GtkOrientation</a>      <a class="link" href="GtkScaleButton.html#gtk-scale-button-get-orientation" title="gtk_scale_button_get_orientation ()">gtk_scale_button_get_orientation</a>    (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkScaleButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
   +----<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
                           +----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
                                 +----<a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a>
                                       +----GtkScaleButton
                                             +----<a class="link" href="GtkVolumeButton.html" title="GtkVolumeButton">GtkVolumeButton</a>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkScaleButton.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkScaleButton implements
 AtkImplementorIface and  <a class="link" href="gtk-gtkbuildable.html#GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkScaleButton.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkScaleButton.html#GtkScaleButton--adjustment" title='The "adjustment" property'>adjustment</a>"               <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>*        : Read / Write
  "<a class="link" href="GtkScaleButton.html#GtkScaleButton--icons" title='The "icons" property'>icons</a>"                    <a
href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html#GStrv"
>GStrv</a>*                : Read / Write
  "<a class="link" href="GtkScaleButton.html#GtkScaleButton--orientation" title='The "orientation" property'>orientation</a>"              <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation">GtkOrientation</a>        : Read / Write
  "<a class="link" href="GtkScaleButton.html#GtkScaleButton--size" title='The "size" property'>size</a>"                     <a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize">GtkIconSize</a>           : Read / Write
  "<a class="link" href="GtkScaleButton.html#GtkScaleButton--value" title='The "value" property'>value</a>"                    <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>               : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkScaleButton.signals"></a><h2>Signals</h2>
<pre class="synopsis">
  "<a class="link" href="GtkScaleButton.html#GtkScaleButton-popdown" title='The "popdown" signal'>popdown</a>"                                        : Run Last / Action
  "<a class="link" href="GtkScaleButton.html#GtkScaleButton-popup" title='The "popup" signal'>popup</a>"                                          : Run Last / Action
  "<a class="link" href="GtkScaleButton.html#GtkScaleButton-value-changed" title='The "value-changed" signal'>value-changed</a>"                                  : Run Last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkScaleButton.description"></a><h2>Description</h2>
<p>
<a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a> provides a button which pops up a scale widget.
This kind of widget is commonly used for volume controls in multimedia
applications, and GTK+ provides a <a class="link" href="GtkVolumeButton.html" title="GtkVolumeButton"><span class="type">GtkVolumeButton</span></a> subclass that
is tailored for this use case.
</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkScaleButton.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="GtkScaleButton-struct"></a><h3>GtkScaleButton</h3>
<pre class="programlisting">typedef struct _GtkScaleButton GtkScaleButton;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-new"></a><h3>gtk_scale_button_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *         gtk_scale_button_new                (<a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize">GtkIconSize</a> size,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> min,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> max,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> step,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **icons);</pre>
<p>
Creates a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>, with a range between <em class="parameter"><code>min</code></em> and <em class="parameter"><code>max</code></em>, with
a stepping of <em class="parameter"><code>step</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
<td> a stock icon size
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>min</code></em> :</span></p></td>
<td> the minimum value of the scale (usually 0)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
<td> the maximum value of the scale (usually 100)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>step</code></em> :</span></p></td>
<td> the stepping of value when a scroll-wheel event,
       or up/down arrow event occurs (usually 2)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icons</code></em> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>-terminated array of icon names, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> if
        you want to set the list later with <a class="link" href="GtkScaleButton.html#gtk-scale-button-set-icons" title="gtk_scale_button_set_icons ()"><code class="function">gtk_scale_button_set_icons()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a new <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-set-adjustment"></a><h3>gtk_scale_button_set_adjustment ()</h3>
<pre class="programlisting">void                gtk_scale_button_set_adjustment     (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                         <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *adjustment);</pre>
<p>
Sets the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> to be used as a model
for the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>'s scale.
See <a class="link" href="GtkRange.html#gtk-range-set-adjustment" title="gtk_range_set_adjustment ()"><code class="function">gtk_range_set_adjustment()</code></a> for details.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>adjustment</code></em> :</span></p></td>
<td> a <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-set-icons"></a><h3>gtk_scale_button_set_icons ()</h3>
<pre class="programlisting">void                gtk_scale_button_set_icons          (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **icons);</pre>
<p>
Sets the icons to be used by the scale button.
For details, see the <a class="link" href="GtkScaleButton.html#GtkScaleButton--icons" title='The "icons" property'><span class="type">"icons"</span></a> property.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icons</code></em> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>-terminated array of icon names
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-set-value"></a><h3>gtk_scale_button_set_value ()</h3>
<pre class="programlisting">void                gtk_scale_button_set_value          (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a> value);</pre>
<p>
Sets the current value of the scale; if the value is outside
the minimum or maximum range values, it will be clamped to fit
inside them. The scale button emits the <a class="link" href="GtkScaleButton.html#GtkScaleButton-value-changed" title='The "value-changed" signal'><span class="type">"value-changed"</span></a>
signal if the value changes.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> new value of the scale button
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-get-adjustment"></a><h3>gtk_scale_button_get_adjustment ()</h3>
<pre class="programlisting"><a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *     gtk_scale_button_get_adjustment     (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);</pre>
<p>
Gets the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> associated with the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>'s scale.
See <a class="link" href="GtkRange.html#gtk-range-get-adjustment" title="gtk_range_get_adjustment ()"><code class="function">gtk_range_get_adjustment()</code></a> for details.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the adjustment associated with the scale

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-get-value"></a><h3>gtk_scale_button_get_value ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>             gtk_scale_button_get_value          (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);</pre>
<p>
Gets the current value of the scale button.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> current value of the scale button

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-get-popup"></a><h3>gtk_scale_button_get_popup ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *         gtk_scale_button_get_popup          (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);</pre>
<p>
Retrieves the popup of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the popup of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-get-plus-button"></a><h3>gtk_scale_button_get_plus_button ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *         gtk_scale_button_get_plus_button    (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);</pre>
<p>
Retrieves the plus button of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the plus button of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-get-minus-button"></a><h3>gtk_scale_button_get_minus_button ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *         gtk_scale_button_get_minus_button   (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);</pre>
<p>
Retrieves the minus button of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the minus button of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-set-orientation"></a><h3>gtk_scale_button_set_orientation ()</h3>
<pre class="programlisting">void                gtk_scale_button_set_orientation    (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation">GtkOrientation</a> orientation);</pre>
<p>
Sets the orientation of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>'s popup window.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>orientation</code></em> :</span></p></td>
<td> the new orientation
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-scale-button-get-orientation"></a><h3>gtk_scale_button_get_orientation ()</h3>
<pre class="programlisting"><a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation">GtkOrientation</a>      gtk_scale_button_get_orientation    (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button);</pre>
<p>
Gets the orientation of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>'s popup window.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> a <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>'s orientation.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkScaleButton.property-details"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="GtkScaleButton--adjustment"></a><h3>The <code class="literal">"adjustment"</code> property</h3>
<pre class="programlisting">  "adjustment"               <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>*        : Read / Write</pre>
<p>The GtkAdjustment that contains the current value of this scale button object.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkScaleButton--icons"></a><h3>The <code class="literal">"icons"</code> property</h3>
<pre class="programlisting">  "icons"                    <a
href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html#GStrv"
>GStrv</a>*                : Read / Write</pre>
<p>
The names of the icons to be used by the scale button.
The first item in the array will be used in the button
when the current value is the lowest value, the second
item for the highest value. All the subsequent icons will
be used for all the other values, spread evenly over the
range of values.
</p>
<p>
If there's only one icon name in the <em class="parameter"><code>icons</code></em> array, it will
be used for all the values. If only two icon names are in
the <em class="parameter"><code>icons</code></em> array, the first one will be used for the bottom
50% of the scale, and the second one for the top 50%.
</p>
<p>
It is recommended to use at least 3 icons so that the
<a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a> reflects the current value of the scale
better for the users.</p>
<p>
</p>
<p>Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkScaleButton--orientation"></a><h3>The <code class="literal">"orientation"</code> property</h3>
<pre class="programlisting">  "orientation"              <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation">GtkOrientation</a>        : Read / Write</pre>
<p>
The orientation of the <a class="link" href="GtkScaleButton.html" title="GtkScaleButton"><span class="type">GtkScaleButton</span></a>'s popup window.</p>
<p>
</p>
<p>Default value: GTK_ORIENTATION_VERTICAL</p>
<p>Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkScaleButton--size"></a><h3>The <code class="literal">"size"</code> property</h3>
<pre class="programlisting">  "size"                     <a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize">GtkIconSize</a>           : Read / Write</pre>
<p>The icon size.</p>
<p>Default value: GTK_ICON_SIZE_SMALL_TOOLBAR</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkScaleButton--value"></a><h3>The <code class="literal">"value"</code> property</h3>
<pre class="programlisting">  "value"                    <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>               : Read / Write</pre>
<p>The value of the scale.</p>
<p>Default value: 0</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkScaleButton.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="GtkScaleButton-popdown"></a><h3>The <code class="literal">"popdown"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)      : Run Last / Action</pre>
<p>
The ::popdown signal is a
keybinding signal
which gets emitted to popdown the scale widget.
</p>
<p>
The default binding for this signal is Escape.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> the object which received the signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkScaleButton-popup"></a><h3>The <code class="literal">"popup"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)      : Run Last / Action</pre>
<p>
The ::popup signal is a
keybinding signal
which gets emitted to popup the scale widget.
</p>
<p>
The default bindings for this signal are Space, Enter and Return.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> the object which received the signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since 2.12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkScaleButton-value-changed"></a><h3>The <code class="literal">"value-changed"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a> *button,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>         value,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)      : Run Last</pre>
<p>
The ::value-changed signal is emitted when the value field has
changed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td> the object which received the signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td> the new value
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since 2.12</p>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.11</div>
</body>
</html>
